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Introduction  to  Agile  (Scrum^ 
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Scrum  is  an  iterative,  incremental 
methodology  for  project  management 
often  seen  in  agile  software 
development,  a  type  of  software 
engineering. 


Prodiicl  Backlog 


Sprint  Backlog  Sprint  "d®  355J" 


Copyrights  specified  as  freely  licensed  media 
http://en.wikipedia.0rg/wiki/File:Scrum_pr0cess.svg 
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Introduction  to  Agile  Systems  Engineering 

For  Software  Development  Requirements  Analysis 
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Agile  Systems  Engineering  Activities 


Agile  Software  Development  Activities 


Richard  Carlson,  Phillip  Matzuc;  A  Viable  Systems  Engineering  Approach,  SSTC  2010 


Copyright  ©2010  Boeing.  All  rights  reserved. 


3 


Agile  Sys  Engrg  Requirements  Analysis 

Parallel  and  One  Iteration  Ahead  of  Software  Development 

Boeing  Defense  Space  &  Security  |  Lean-Agile  Software 


Richard  Carlson,  Phillip  Matzuc;  A  Viable  Systems  Engineering  Approach,  SSTC  2010 


Copyright  ©2010  Boeing.  All  rights  reserved. 


4 


Analysis  of  Existing  Code 
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■  Have: 

■  Code 

■  Test  Bed 

■  User  Interface 

■  User  Procedures 

■  Lack: 

■  Requirements  documentation 

■  Architecture  &  Design  Diagrams 

■  Trace  Matrix  of  Tests  to  Requirements 

■  Software  Test  Descriptions 

■  Hazard  Analysis 
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Analysis  with  Integrated  Toolset 
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Getting  Started 
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■Code 

■  Domain  experts  -  not  always  available 

■  Existing  documentation  in  program  repositories  -  charts, 
operator  procedures 

■  Determine  Next  Steps 


Copyright  ©2010  Boeing.  All  rights  reserved. 


7 


Epics  and  Backlog  Items 
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■  30  Epics  were  created  from  the  User  Interface  Features,  examples: 

■  Power  On 

■  Start  Up  Feature 

■  Shutdown  Feature 

■  Operate  Component 

■  Operate  Another  Component 

■  Product  Owner  prioritized  the  most  important  ones 

■  Each  epic  has  5  significant  backlog  items  (took  3  Iterations  to 
reach  these  5): 

■  Functional  Analysis 

■  Requirements 

■  Hazard  Analysis 

■  Draft  Test  Procedure 

■  Finalize  Test  Procedure 
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Create  Documentation  Feature  by  Feature 

Bosing  Dsfsnss  Sp3CG  &  Sscurity  I  LG3lvAgil6  B  Backlog  Item  Templates 


■  Created  templates 

■  Goal  is  to  identify  tasks 
that  take  16  hour  max 

■  Include  what  “Done” 
means  in  the  template 


El  Filter’*' 

Move  to  Project 

Q  00  Title 

ID 

□  [|pS  User  Story  Template  -  OLD 

B-01017 

□  [^Task  Template  -  OLD 

B-01018 

[gp  Update  Documentation  or  Work  Products  Template 

B-01243 

]  Functional  Analysis  Template 

B-01225 

§6$  Research  and  Document  Functionality 

TK-02479 

]  Requirements  Template 

B-01216 

§6$  Generate  Functional  Requirements 

TK-02420 

§8$  Peer  Review  Requirements 

TK-02422 

§8$  Update  and  Post  Requirements 

TK-02469 

]  Hazard  Analysis  Template 

B-01219 

§8$  Identify  and  Analyze  Potential  Hazards 

TK-02546 

§6$  Peer  Review  Hazard  Analysis 

TK-02547 

§6$  Update  Hazard  Analysis 

TK-02548 

]  Draft  Test  Procedures  Template 

B-01252 

§8$  Generate  Draft  Test  Procedures 

TK-02543 

§8$  Peer  Review  Draft  Test  Procedures 

TK-02544 

§6$  Update  and  Post  Draft  Test  Procedures 

TK-02545 

]  Finalize  Test  Procedure  Template 

B-01251 

§8$  Run  Test  Procedures 

TK-02539 

§8$  Update  and  Post  Finalized  Test  Procedures 


TK-02540 


Copyright  ©2010  Boeing.  All  rights  reserved. 


9 


Manage  the  Backlog 
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■Application  Lifecycle  Management  (ALM)  Tools 

■  IBM  -  Rational  Team  Concert 

■  MKS,  Inc. 

■  Atlassian  -  JIRA  with  GreenHopper 

■  CollabNet 

■  HP 

■  Micro  Focus 

■  Microsoft 

■  Rally  Software  Development 

■  Serena  Software 

■  VersionOne 

http://adtmag.com/articles/2010/05/12/ibm-mks-have-best-agile-management-tools.aspx 
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Integrated  End-to-End  Tools 

Boeing  Defense  Space  &  Security  |  Lean-Agile  Software 
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formatting 
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Configuration  Control 
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Collaboration 

Boeing  Defense  Space  &  Security  |  Lean-Agile  Software 


■Collaboration  tool  should  be: 

■  Easy  to  access 

■  Easy  to  use 

■  Easy  to  comment 

■  Easy  to  change 

■Team  started  with  a  collaborative  tool 

■  Mediawiki,  open  source 

■  TWiki™,  open  source,  collaboration  platform 

■  Confluence 

■  SharePoint 

■  Socialtext 
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Collaboration  -  Home  Page 

Boeing  Defense  Space  &  Security  |  Lean-Agile  Software 


■  Introduction  about  the  analysis  underway 

■  Link  to  a  list  of  functional  threads:  links  have  the  work  products 
themselves 

■  Links  to  references  used 

■  Links  to  test  environment  information 

■  Links  to  templates  for  work  products  with  instructions 

■  Collaboration  Tool  Templates 

■  Functional  Descriptions 

■  Requirements/Use  Cases/ 

■  Hazard  Analysis/Risk  Mitigation 

■  Test  Procedures/Test  Cases/Test  Descriptions 
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Example 

Boeing  Defense  Space  &  Security  |  Lean-Agile  Software 


"  Collaboration  tool  exports 
content  to  a  Word  Document 

■  Word  Document  is  parsed  into 
DOORS 

■  All  feature  reqmts  in  DOORS 
create  final  SRS 

■  Released  documents  are 
baselined  in  the  Data  Mgmt 
Tool  Repository  that  provides 
Configuration  Mgmt  control 
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4-  Description  of  Functionality 
4  Overview 

4  Fun ction al  Deco m position _ 

4  Use  Case  Development 
4  Phase  1  level 

4  Requirements 

4  Use  Case  Development 

4  Phase  1  (operator/functional)  level 
4  Functional  Requirements 
4  Requirements  Documents 
4  S_R  S  D  o  c  u  m  e  nt  j  n_  TWi  ki 
4  SRS  D o_c u me nt  in  D 0 O R  S 
4  SRS  Doc u m e nt_ in  _P IM_S_ 

4  Test_Pro_cedures_ 

4  Existing  Test  Procedures 
4  FQT  Team  Test  Case/Test  Procedure  Development 
4  Test  Cases 

4  Test  Procedure  Document 
4  Expected  Test  Results 
4  Test  Procedures  _to_  Requirements _T race 
4  Software  T est .Description  (STD) 

4  Test  Results 

4  Hazard  AnaJysis/Risk  Mitiqation 
4  Hazards/Mitiqation 


Data  Management  Tool  /  Repository 

Boeing  Defense  Space  &  Security  |  Lean-Agile  Software 


■Capabilities  include: 

■  Draft  folders/repository 

■  Peer  Review  records 

■  Action  Item  creating/tracking/closure 

■  Release  folders/repository 

■  Calendar 

■  Meeting  notification 

■  Distribution  Lists  and  access  control  to  records 

■  Configuration  Management  work  flow  and  approvals 

■  Collaboration  across  companies,  subcontractors,  customers 

■  Examples  (to  name  a  few) 

■  Master  Data  Management  Tool:  Microsoft,  Data  Foundations,  Kalido, 

■  Business  to  Business  Tools,  Amalto  Technologies,  Entreon  Corp., 
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Documentation 
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■  During  each  iteration: 

■  Software  Requirement  Specification  is  created  Feature  by  Feature  rather  than 
all  at  once. 

■  Software  Test  Descriptions  are  created  as  each  feature  is  analyzed 

■  Hazard  Analysis  is  performed  one  feature  at  a  time. 

■  At  each  release: 

■  More  features  are  complete  within  the  SRS, 

■  More  STDs  are  complete  and 

■  More  Hazards  Analysis  are  complete. 
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Peer  Reviews 

Boeing  Defense  Space  &  Security  |  Lean-Agile  Software 


■  Each  backlog  item  included  conducting  peer  reviews  of  the  content. 

■  The  peer  review  was  the  acceptance  criteria  before  work  could  be 
posted  into  DOORS  or  claimed  done  and  be  included  into  the 
demonstration  of  the  iteration 

■  One  team  member  responsible  for  the  entire  backlog  item  of  tasks 
but  other  team  members  might  be  actually  performing  the  tasks. 

■  Conducting  peer  reviews,  as  soon  as  possible,  instead  of  waiting 
until  the  week  before  the  demonstration,  helped  get  findings 
removed  and  more  work  ready  for  demonstration. 

■  Peer  Review  records  were  kept  in  a  data  management  tool  where 
the  data  included: 

■  Artifact  in  review 

■  Peer  review  date, 

■  Personnel  reviewing, 

■  Time  spent  reviewing, 

■  Findings  discovered  and  removed 
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Define  “Done”  -  Includes  Logging 
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■Work  was  not  complete  until  content  was  posted  into  the 
Requirements  Management  Tool 

-  INCOSE  site  has  34  listed  as  of  3/18/201 1 : 
http://www.incose.org/ProductsPubs/products/rmsurvev.aspx 

■Two  in  use  at  Boeing: 

■  IBM  Rational  DOORS 

■  IBM  Rational  RequisitePro 

■  Unique  record  Identification  numbers  are  automatically 
assigned 


Copyright  ©2010  Boeing.  All  rights  reserved. 


18 


Software  Test  Descriptions 

Boeing  Defense  Space  &  Security  |  Lean-Agile  Software 


■  Developed  the  software  test  descriptions 

■  Ran  these  in  the  Test  Lab  to  verify  complete 

■  Found  some  common  repeatable  test  steps 

■  Created  these  as  common  test  descriptions  that  could  be  called 
from  other  procedures  reducing  work  and  making  future  test 
procedure  development  faster. 

■  Linking  the  STDs  to  the  requirements  in  the  requirements 
management  tool  began  the  Trace  Matrix 
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Formal  Document  Production^ 
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■  The  format  for  the  Software  Requirement  Specification  followed 
company  standards  and  was  populated  into  the  requirements 
management  tool 

■  As  each  release  occurred  the  document  produced  met  format 
standards. 

■  The  format  of  the  Software  Test  Descriptions  followed  company 
standards  and  was  posted  into  the  collaboration  tool  so  all 
documents  started  with  the  standard  format 

■  STDs  were  posted  into  requirements  management  tool  and  content 
linked  to  requirements  to  enable  the  production  of  the  Trace  Matrix 
eventually. 
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Data  Availability  &  Consistency 
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■  Each  day  the  requirements  in  the  Requirements 
Management  Tool  was  exported  into  an  HTML  file  onto  a 
web  page  so  that  those  not  familiar  with  or  licensed  for  the 
Requirements  Management  Tool  could  see  the  latest,  most 
complete  list 

■  Each  month  the  requirements  and  test  descriptions  in  the 
Requirements  Management  Tool  could  be  exported  into 
word  files  to  be  posted  as  drafts  into  the  Data  Management 
Repository  so  those  more  comfortable  working  with 
documents  could  see  the  latest  demonstrated  list 

■  Each  quarter  the  requirements  and  test  descriptions  in  the 
Requirements  Management  Tool  were  exported  into  word 
files  to  be  posted  as  releases  into  the  Data  Management 
Repository 
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Configuration  Control  for  SRS 
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■  Sequence  of  events: 

■  Develop  draft  in  collaboration  tool 

■  Perform  peer  review  using  the  data  management  tool 

■  Populate  requirements  management  tool 

■  Create  the  final  SRS  word  document  from  the  requirements 
management  tool  and  post  baseline  into  the  data  management  tool. 

■  Changes  to  baselined  content  approved  in  a  Change  Board 

■  Approved  changes  added  to  Product  Backlog  based  on  priority 
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Configuration  Control  for  STB. 
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■  Sequence  of  events: 

■  Develop  draft  in 
collaboration  tool 

■  Perform  peer  review  using 
the  data  management  tool 

■  Run  the  test  in  the  test  lab, 
redline  the  STD 

■  Update  the  collaboration 
tool  with  redlines 

■  Update  the  requirements  as 
needed 

■  Perform  peer  review  with 
updates/redlines 

■  Run  the  updated  test  in  the 
test  lab 
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Configuration  Control  for  STB^(Cont.) 
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■  Sequence  of  events: 

■  Finalize  the  STD 

■  Populate  the  STD  into  the 
requirements  management 
tool 

■  Link  the  test  descriptions  to 
the  requirements  that  are 
verified 

■  Create  the  final  STD  word 
document  from  the 
requirements  management 
tool  and  post  baseline  into 
the  data  management  tool. 

■  Changes  to  baselined 
content  approved  in  a 
Change  Board 


■  Approved  changes  added  to 
Product  Backlog  based  on 
priority 
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|  LEAN  Disciplines 

Agile  Requirements  Analysis  j 

1.  Establish  Clear  Priorities 

1.  Product  backlog  is  always 
prioritized;  Team  works  on  highest 
priority  items  first 

2.  Eliminate  Bad  Multitasking  - 
Focus  and  Finish 

2.  Team  is  shielded  from 
interruptions  that  cause  bad 
multitasking 

3.  Limit  the  Release  of  Work  in 
Process  (WIP)  to  Deliver  Earlier 

3.  Tasks  are  pulled  from  the 
iteration  backlog  one  at  a  time  to 
limit  individual  WIP 

4.  Prepare!  Start — ►Finish 

4.  Requirements  are  not  selected 
from  the  product  backlog  until 
everything  needed  is  available 

5.  Use  Checklists  to  Prevent  Defects 
and  Traveled  Risk 

5.  Checklists  and  guides  are  used  to 
prevent  costly  rework 

6.  Face  into  and  Resolve  Issues 
Quickly 

6.  Daily  stand-up  meetings  force 
issues  and  risks  to  be  identified  and 
resolved  quickly 

7.  Drive  Daily  Execution 

7.  Daily  stand-up  meetings  drive 
team-based  execution 
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Acronyms  and  Abbreviations 


Docs  Documents 


DOORS  Dynamic  Object-Oriented  Requirements 

System 


EAR 

Export  Administration  Regulations 

FQT 

Functional  Qualification  Test 

h 

Hours 

HTML 

Hypertext  Markup  Language 

ID 

Identification 

INCOSE 

International  Council  On  Systems 
Engineering 

IAW 

In  Accordance  With 

ITAR 

International  Traffic  in  Arms  Regulation 

Mgmt 

Management 

PRO 

Boeing  Procedure 

Reqmts 

Requirements 

SRS 

Software  Requirement  Specification 

STD 

Software  Test  Description 

Sys  Engrg 

System  Engineering 
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Abstract 
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An  Integrated  Toolset  for  Agile  Systems  Engineering 
Requirements  Analysis  introduces  an  iterative  approach  to 
analyzing  requirements  and  the  integrated  toolset  that  enables 
this  analysis.  The  requirements  analysis  may  occur  in  parallel 
and  one  iteration  ahead  of  software  development  or  it  may 
occur  after  software  exists  to  produce  needed  artifacts  as  in 
the  case  to  be  presented.  An  agile  process  for  systems 
engineering  to  analyze  requirements  and  provide  to  the  agile 
software  team  will  be  introduced.  The  commercial-off-the-shelf 
tools  that  allow  collaboration,  standard  formatting,  logging, 
unique  identification  numbering,  linking  to  defined  tests,  and 
formal  document  production,  configuration  control  and  actual 
program  use  will  be  presented.  This  end-to-end  integrated 
toolset  allows  the  sync-up  of  the  requirements  to  test 
descriptions  not  only  at  each  formal  release,  but  daily  as  the 
requirements  evolve  during  the  iterations.  This  results  in 
planned  deliverable  products  at  the  end  of  each  iteration  to 
internal  and  external  customers. 
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